İlk Program

int WINAPI WinMain (HINSTANCE hThisInstance,
                     HINSTANCE hPrevInstance,
                     LPSTR lpszArgument,
                     int nCmdShow)

WINAPI

windef.h dosyası içinde #define WINAPI __stdcall şeklinde tanımlanan WINAPI makrosu WinMain() fonksiyonunun __stdcall şeklinde çağrılacağını gösterir. Bu çağrı şekli derleyicinin fonksiyon argümanlarını stack'e ne şekilde koyup alacağı ve sileceği ile bir dönüş değeri alması ile ilgili kuralları belirler. __stdcall yöntemi Win32 API fonksiyonlarını çağırmak için kullanılır.

HINSTANCE hThisInstance

Program .exe dosyasının bellekteki halinin Handle (*)'ı. hInstance değeri kaynakları yükleme ve diğer işlemleri gerçekleştirmek için kullanılır.

HINSTANCE hPrevInstance

Win32 program için daima NULL bir değerdir. hPrevInstance, Win16 sistemlerde programın çalışan önceki hali için bir Handle olarak kullanılır.

LPSTR lpszArgument

Tek bir karakter dizisi halinde verilen, programın adı hariç olmak üzere, komut satırı argümanlarıdır. C programlama diline ek olarak Microsoft için tanımlanmış özel veri türlerinden bir tanesi de LPSTR verisidir. Bu veri winnt.h dosyasında typedef CHAR *LPSTR şeklinde tanımlanmıştır. Windows veri türlerine Windows veri türleri adresinden ulaşabilirsiniz.

int nCmdShow

ShowWindow() fonksiyonuna geçirilebilecek integer bir değer gösterir.

* HANDLE: winnt.h dosyasında typedef PVOID HANDLE şeklinde tanımlanmış bir değerdir.

HWND hwnd;               /* Program ana penceresi için handle değeri */
MSG messages;            /* Program ana penceresine gönderilen mesajların kaydedildiği değişken */
WNDCLASSEX wincl;        /* Program ana pencere sınıfına ait veri yapısı */

HWND hwnd

HWND windef.h dosyası içinde tanımlanmış olan pencere Handle değeridir.

MSG messages

MSG winuser.h dosyası içinde aşağıdaki şekilde tanımlanmış olan bir yapıdır:

typedef struct tagMSG {
	HWND hwnd;      
	UINT message;   
	WPARAM wParam;  
	LPARAM lParam;  
	DWORD time;     
	POINT pt;       
} MSG;

typedef struct tagPOINT {
  LONG x;
  LONG y;
} POINT;

WNDCLASSEX wincl

winuser.h dosyası içinde aşağıdaki şekilde tanımlanmış olan bir yapıdır:

typedef struct _WNDCLASSEXA {
	UINT cbSize;
	UINT style;
	WNDPROC lpfnWndProc;
	int cbClsExtra;
	int cbWndExtra;
	HINSTANCE hInstance;
	HICON hIcon;
	HCURSOR hCursor;
	HBRUSH hbrBackground;
	LPCSTR lpszMenuName;
	LPCSTR lpszClassName;
	HICON hIconSm;
} WNDCLASSEXA;

typedef WNDCLASSEXA WNDCLASSEX;

/* Program ana pencere sınıfı veri yapısına değer atama */
wincl.hInstance = hThisInstance;
wincl.lpszClassName = szClassName;
wincl.lpfnWndProc = WindowProcedure;      /* Windows tarafından çağrılan ve tüm mesaj işlemlerini yapan ana pencere fonksiyonu */
wincl.style = CS_DBLCLKS;                 /* Çift tıklamaya işlem yapılmasını sağlayan stil değerini ekleme */
wincl.cbSize = sizeof (WNDCLASSEX);       /* Bu değişkenine sizeof(WNDCLASSEX) değeri atanmalıdır. */

/* Ön tanımlı ikon ve mouse imlecinin kullanılmasını sağlama */
wincl.hIcon = LoadIcon (NULL, IDI_APPLICATION);
wincl.hIconSm = LoadIcon (NULL, IDI_APPLICATION);
wincl.hCursor = LoadCursor (NULL, IDC_ARROW);
wincl.lpszMenuName = NULL;                /* Menü tanımı yok. */
wincl.cbClsExtra = 0;                     /* Pencere sınıfı için ektra byte tanımı yok. */
wincl.cbWndExtra = 0;                     /* Pencere Instance değeri için ayrılacak ekstra byte sayısını gösterir. */    
wincl.hbrBackground = (HBRUSH) COLOR_BACKGROUND; /* Ana pencere arka plan rengi için Windows'un ön tanımlı değerini kullanır. */

/* Pencere sınıfını kaydeder, başarılı olmazsa program sona erer. */
if (!RegisterClassEx (&wincl))
	return 0;

UINT cbSize

Yapının byte olarak değerini gösterir. sizeof (WNDCLASSEX) ile değer atanır.

UINT style

Sınıf tipleri pencere sınıfı için ek özellikler sağlar. İki veya daha fazla sınıf tipi OR (|) bit işlemcisi ile birlikte tanımlanabilir. CS_ ifadesi ile başlayan sınıf tipi makroları winuser.h dosyası içinde tanımlanmıştır.

WNDPROC lpfnWndProc

Program pencere fonksiyonunu gösteren bir işaretçidir.

int cbClsExtra

Pencere sınıfından sonra tahsis edilecek ekstra byte miktarını gösterir. Sistem ayrılan byte'lara ilk değer olarak sıfır değeri verir.

int cbWndExtra

Pencere instance sonrası tahsis edilecek ekstra byte miktarını gösterir. Sistem ayrılan byte'lara ilk değer olarak sıfır değeri verir. Eğer bir uygulama kaynak dosya içinde CLASS direktifi kullanarak oluşturduğu bir diyalog kutusunu kaydetmek için WNDCLASSEX kullanırsa, bu elemana DLGWINDOWEXTRA değerini vermelidir.

HINSTANCE hInstance

Program .exe dosyasının bellekteki kopyasını gösteren bir Handle değerdir. Bu değer WinMain() fonksiyonuna geçirilen ilk argümandır. HINSTANCE veri türü, windef.h dosyasında typedef HANDLE HINSTANCE şeklinde tanımlanmış bir değerdir.

HICON hIcon

Program ikonunu gösteren bir Handle değerdir. Bu elemana NULL bir değer atandığında, sistem aktif ikonu atar. HICON veri türü, windef.h dosyasında typedef HANDLE HICON şeklinde tanımlanmış bir değerdir.

HCURSOR hCursor

Program kursor'ını gösten bir Handle değerdir. Bu elemana NULL bir değer atandığında, uygulama, fare uygulama penceresi içine girdiğinde kursor şeklini belirlemlidir. HCURSOR veri türü, windef.h dosyasında typedef HICON HCURSOR şeklinde tanımlanmış bir değerdir.

HBRUSH hbrBackground

Program pencere rengini belirleyen fırça rengini gösteren bir Handle değerdir. HBRUSH veri türü, windef.h dosyasında typedef HANDLE HBRUSH şeklinde tanımlanmış bir değerdir.

LPCTSTR lpszMenuName

Program ile kullanılacak kaynak dosyasında yer alan menü adını gösterir. LPCTSTR veri türü, winnt.h dosyasında typedef LPCSTR LPCTSTR şeklinde tanımlanmış bir değerdir. LPCSTR veri türü ise, winnt.h dosyasında typedef CONST CHAR *LPCSTR şeklinde tanımlanmış bir değerdir.

LPCTSTR lpszClassName

Program sınıf adını gösterir.

HICON hIconSm

Program için kullanılan küçük ikonu gösteren bir Handle değerdir.

Pencere yapısının değerleri atandıktan sonra, CreateWindowEx() fonksiyonu ile penceremizi oluşturmak için öncelikle RegisterClassEx() fonksiyonunu kullanarak pencere yapısını kaydetmemiz gerekir. Eğer bu fonksiyon bir hata verirse, program sıfır değeri geri vererek çalışmasını sona erdirir.

/* Program ana pencere sınıfı kaydedildiğinden, program ana penceresini oluşturma */
hwnd = CreateWindowEx (
	   0,                   /* Pencereye ek özellikler sağlar. */
	   szClassName,         /* Sınıf adı */
	   _T("Code::Blocks Template Windows App"),  /* Pencere başlığı */
	   WS_OVERLAPPEDWINDOW, /* Ön tanımlı pencere */
	   CW_USEDEFAULT,       /* Pencerenin sol üst köşesinin x koordinatını Windows belirler. */
	   CW_USEDEFAULT,       /* Pencerenin sol üst köşesinin y koordinatını Windows belirler. */
	   544,                 /* Ana pencere genişliği piksel olarak */
	   375,                 /* Ana pencere yüksekliği piksel olarak */
	   HWND_DESKTOP,        /* Ana pencerenin masaüstünün alt pencersi olduğunu gösterir. */
	   NULL,                /* Menü yok. */
	   hThisInstance,       /* Program Instance handler değeri */
	   NULL                 /* Pencere oluşturma bilgisi yok. */
	   );

/* Ana pencereyi ekran da gösterir. */
ShowWindow (hwnd, nCmdShow);

HWND WINAPI CreateWindowEx(
   DWORD dwExStyle,
   LPCTSTR lpClassName,
   LPCTSTR lpWindowName,
   DWORD dwStyle,
   int x,
   int y,
   int nWidth,
   int nHeight,
   HWND hWndParent,
   HMENU hMenu,
   HINSTANCE hInstance,
   LPVOID lpParam
);

typedef struct tagCREATESTRUCT {
  LPVOID    lpCreateParams;
  HINSTANCE hInstance;
  HMENU     hMenu;
  HWND      hwndParent;
  int       cy;
  int       cx;
  int       y;
  int       x;
  LONG      style;
  LPCTSTR   lpszName;
  LPCTSTR   lpszClass;
  DWORD     dwExStyle;
} CREATESTRUCT;

Penceremizi CreateWindowEx() fonksiyonu ile oluşturduktan sonra ShowWindow() fonksiyonu ile ekranda gösteririz. ShowWindow() fonksiyonu hwnd Handle değerini CreateWindowEx() fonksiyonunun geri verdiği değerden, nCmdShow değerini ise WinMain() fonksiyonunun son parametresinden alır.

/* Mesaj döngüsünü devre sokar. Bu döngü GetMessage() fonksiyonu 0 değeri döndürene kadar çalışmaya devam eder. */
while (GetMessage (&messages, NULL, 0, 0))
{
	/* Sanal tuş mesajlarını karakter mesajlarına çevirir. */
	TranslateMessage(&messages);
	/* Mesajları WindowProcedure() fonksiyonuna gönderir. */
	DispatchMessage(&messages);
}

/* Program dönüş değeri 0'dır - Bu değeri PostQuitMessage() fonksiyonu verir. */
return messages.wParam;

BOOL WINAPI GetMessage(
  LPMSG lpMsg,
  HWND hWnd,
  UINT wMsgFilterMin,
  UINT wMsgFilterMax
);

TranslateMessage() sanal tuş mesajlarını karakter mesajlarına çevirir. DispatchMessage() mesajları WindowProcedure() fonksiyonuna gönderir.

Herhangi bir nedenle while döngüsünden çıkılırsa, messages.wParam değeri geri döndürülerek program sona erer.

/* Bu fonksiyon Windows'un DispatchMessage() fonksiyonu tarafından çağrılır. */
LRESULT CALLBACK WindowProcedure (HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    switch (message)                  /* Mesajlara gerekli işlemi yapar. */
    {
        case WM_DESTROY:
            PostQuitMessage (0);      /* WM_QUIT değerini mesaj kuyruğuna gönderir */
            break;
        default:                      /* İşlem yapılmayan mesajlar için */
            return DefWindowProc (hwnd, message, wParam, lParam);
    }

    return 0;
}

WindowProcedure() fonksiyonu her mesaj için çağrılır. Herhangi bir mesaja işlem yapılmadığında DefWindowProc() fonksiyonu çağrılır.

WM_DESTROY mesajı geldiğinde PostQuitMessage() fonksiyonu çağrılır. PostQuitMessage() fonksiyonu WM_QUIT mesajını mesaj kuyruğuna gönderir. Bu mesaj GetMessage() foksiyonunun FALSE bir değer geri vermesini sağladığından, while döngüsünün ve programın çalışması sona erer.